/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.cassandra.dht;

import java.nio.ByteBuffer;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashSet;
import java.util.List;
import java.util.Objects;
import java.util.Random;
import java.util.Set;

import com.google.common.base.Joiner;
import com.google.common.base.Stopwatch;
import com.google.common.collect.ImmutableList;
import com.google.common.collect.Sets;
import org.apache.commons.lang3.StringUtils;
import org.junit.BeforeClass;
import org.junit.Test;

import org.apache.cassandra.CassandraTestBase;
import org.apache.cassandra.CassandraTestBase.DDDaemonInitialization;
import org.apache.cassandra.config.CassandraRelevantProperties;
import org.apache.cassandra.db.PartitionPosition;
import org.apache.cassandra.dht.ByteOrderedPartitioner.BytesToken;
import org.apache.cassandra.dht.Murmur3Partitioner.LongToken;
import org.apache.cassandra.dht.RandomPartitioner.BigIntegerToken;
import org.apache.cassandra.utils.Pair;

import static java.lang.String.format;
import static java.util.Arrays.asList;
import static java.util.Collections.emptyList;
import static java.util.concurrent.TimeUnit.SECONDS;
import static org.apache.cassandra.Util.range;
import static org.apache.cassandra.config.CassandraRelevantProperties.TEST_RANGE_EXPENSIVE_CHECKS;
import static org.apache.cassandra.dht.NormalizedRanges.normalizedRanges;
import static org.apache.cassandra.dht.Range.fromString;
import static org.apache.cassandra.dht.Range.intersectionAndRemainder;
import static org.apache.cassandra.dht.Range.normalize;
import static org.junit.Assert.assertEquals;
import static org.junit.Assert.assertFalse;
import static org.junit.Assert.assertNotSame;
import static org.junit.Assert.assertNull;
import static org.junit.Assert.assertTrue;
import static org.junit.Assert.fail;


@DDDaemonInitialization
public class RangeTest extends CassandraTestBase
{
    @BeforeClass
    public static void enableExpensiveRangeChecks()
    {
        assertFalse(TEST_RANGE_EXPENSIVE_CHECKS.getBoolean()); // Expect off by default
        CassandraRelevantProperties.TEST_RANGE_EXPENSIVE_CHECKS.setBoolean(true);
        assertTrue(TEST_RANGE_EXPENSIVE_CHECKS.getBoolean());
    }

    @Test
    public void testContains()
    {
        Range<Token> left = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("100"));
        assert !left.contains(new BigIntegerToken("0"));
        assert left.contains(new BigIntegerToken("10"));
        assert left.contains(new BigIntegerToken("100"));
        assert !left.contains(new BigIntegerToken("101"));
    }

    @Test
    public void testContainsWrapping()
    {
        Range<Token> range = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("0"));
        assert range.contains(new BigIntegerToken("0"));
        assert range.contains(new BigIntegerToken("10"));
        assert range.contains(new BigIntegerToken("100"));
        assert range.contains(new BigIntegerToken("101"));

        range = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("0"));
        assert range.contains(new BigIntegerToken("0"));
        assert !range.contains(new BigIntegerToken("1"));
        assert !range.contains(new BigIntegerToken("100"));
        assert range.contains(new BigIntegerToken("200"));
    }

    @Test
    public void testContainsRange()
    {
        Range<Token> one = new Range<Token>(new BigIntegerToken("2"), new BigIntegerToken("10"));
        Range<Token> two = new Range<Token>(new BigIntegerToken("2"), new BigIntegerToken("5"));
        Range<Token> thr = new Range<Token>(new BigIntegerToken("5"), new BigIntegerToken("10"));
        Range<Token> fou = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("12"));

        assert one.contains(two);
        assert one.contains(thr);
        assert !one.contains(fou);

        assert !two.contains(one);
        assert !two.contains(thr);
        assert !two.contains(fou);

        assert !thr.contains(one);
        assert !thr.contains(two);
        assert !thr.contains(fou);

        assert !fou.contains(one);
        assert !fou.contains(two);
        assert !fou.contains(thr);
    }

    @Test
    public void testContainsRangeWrapping()
    {
        Range<Token> one = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("2"));
        Range<Token> two = new Range<Token>(new BigIntegerToken("5"), new BigIntegerToken("3"));
        Range<Token> thr = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("12"));
        Range<Token> fou = new Range<Token>(new BigIntegerToken("2"), new BigIntegerToken("6"));
        Range<Token> fiv = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("0"));

        assert !one.contains(two);
        assert one.contains(thr);
        assert !one.contains(fou);

        assert two.contains(one);
        assert two.contains(thr);
        assert !two.contains(fou);

        assert !thr.contains(one);
        assert !thr.contains(two);
        assert !thr.contains(fou);

        assert !fou.contains(one);
        assert !fou.contains(two);
        assert !fou.contains(thr);

        assert fiv.contains(one);
        assert fiv.contains(two);
        assert fiv.contains(thr);
        assert fiv.contains(fou);
    }

    @Test
    public void testContainsRangeOneWrapping()
    {
        Range<Token> wrap1 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("0"));
        Range<Token> wrap2 = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("2"));

        Range<Token> nowrap1 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("2"));
        Range<Token> nowrap2 = new Range<Token>(new BigIntegerToken("2"), new BigIntegerToken("10"));
        Range<Token> nowrap3 = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("100"));

        assert wrap1.contains(nowrap1);
        assert wrap1.contains(nowrap2);
        assert wrap1.contains(nowrap3);

        assert wrap2.contains(nowrap1);
        assert !wrap2.contains(nowrap2);
        assert wrap2.contains(nowrap3);
    }

    @Test
    public void testIntersects()
    {
        Range<Token> all = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("0")); // technically, this is a wrapping range
        Range<Token> one = new Range<Token>(new BigIntegerToken("2"), new BigIntegerToken("10"));
        Range<Token> two = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("8"));
        Range<Token> not = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("12"));

        assert all.intersects(one);
        assert all.intersects(two);

        assert one.intersects(two);
        assert two.intersects(one);

        assert !one.intersects(not);
        assert !not.intersects(one);

        assert !two.intersects(not);
        assert !not.intersects(two);
    }

    @Test
    public void testIntersectsWrapping()
    {
        Range<Token> onewrap = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("2"));
        Range<Token> onecomplement = new Range<Token>(onewrap.right, onewrap.left);
        Range<Token> onestartswith = new Range<Token>(onewrap.left, new BigIntegerToken("12"));
        Range<Token> oneendswith = new Range<Token>(new BigIntegerToken("1"), onewrap.right);
        Range<Token> twowrap = new Range<Token>(new BigIntegerToken("5"), new BigIntegerToken("3"));
        Range<Token> not = new Range<Token>(new BigIntegerToken("2"), new BigIntegerToken("6"));

        assert !onewrap.intersects(onecomplement);
        assert onewrap.intersects(onestartswith);
        assert onewrap.intersects(oneendswith);

        assert onewrap.intersects(twowrap);
        assert twowrap.intersects(onewrap);

        assert !onewrap.intersects(not);
        assert !not.intersects(onewrap);

        assert twowrap.intersects(not);
        assert not.intersects(twowrap);
    }

    @SafeVarargs
    static <T extends RingPosition<T>> void assertIntersection(Range<T> one, Range<T> two, Range<T>... ranges)
    {
        Set<Range<T>> correct = Range.rangeSet(ranges);
        Set<Range<T>> result1 = one.intersectionWith(two);
        assert result1.equals(correct) : format("%s != %s",
                                                       StringUtils.join(result1, ","),
                                                       StringUtils.join(correct, ","));
        Set<Range<T>> result2 = two.intersectionWith(one);
        assert result2.equals(correct) : format("%s != %s",
                                                       StringUtils.join(result2, ","),
                                                       StringUtils.join(correct, ","));
    }

    private void assertNoIntersection(Range<Token> wraps1, Range<Token> nowrap3)
    {
        assertIntersection(wraps1, nowrap3);
    }

    @Test
    public void testIntersectionWithAll()
    {
        Range<Token> all0 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("0"));
        Range<Token> all10 = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("10"));
        Range<Token> all100 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("100"));
        Range<Token> all1000 = new Range<Token>(new BigIntegerToken("1000"), new BigIntegerToken("1000"));
        Range<Token> wraps = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("10"));

        assertIntersection(all0, wraps, wraps);
        assertIntersection(all10, wraps, wraps);
        assertIntersection(all100, wraps, wraps);
        assertIntersection(all1000, wraps, wraps);
    }

    @Test
    public void testIntersectionContains()
    {
        Range<Token> wraps1 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("10"));
        Range<Token> wraps2 = new Range<Token>(new BigIntegerToken("90"), new BigIntegerToken("20"));
        Range<Token> wraps3 = new Range<Token>(new BigIntegerToken("90"), new BigIntegerToken("0"));
        Range<Token> nowrap1 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("110"));
        Range<Token> nowrap2 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("10"));
        Range<Token> nowrap3 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("9"));

        assertIntersection(wraps1, wraps2, wraps1);
        assertIntersection(wraps3, wraps2, wraps3);

        assertIntersection(wraps1, nowrap1, nowrap1);
        assertIntersection(wraps1, nowrap2, nowrap2);
        assertIntersection(nowrap2, nowrap3, nowrap3);

        assertIntersection(wraps1, wraps1, wraps1);
        assertIntersection(nowrap1, nowrap1, nowrap1);
        assertIntersection(nowrap2, nowrap2, nowrap2);
        assertIntersection(wraps3, wraps3, wraps3);
    }

    @Test
    public void testNoIntersection()
    {
        Range<Token> wraps1 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("10"));
        Range<Token> wraps2 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("0"));
        Range<Token> nowrap1 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("100"));
        Range<Token> nowrap2 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("200"));
        Range<Token> nowrap3 = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("100"));

        assertNoIntersection(wraps1, nowrap3);
        assertNoIntersection(wraps2, nowrap1);
        assertNoIntersection(nowrap1, nowrap2);
    }

    @Test
    public void testIntersectionOneWraps()
    {
        Range<Token> wraps1 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("10"));
        Range<Token> wraps2 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("0"));
        Range<Token> nowrap1 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("200"));
        Range<Token> nowrap2 = new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("100"));

        assertIntersection(wraps1,
                           nowrap1,
                           new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("10")),
                           new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("200")));
        assertIntersection(wraps2,
                           nowrap1,
                           new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("200")));
        assertIntersection(wraps1,
                           nowrap2,
                           new Range<Token>(new BigIntegerToken("0"), new BigIntegerToken("10")));
    }

    @Test
    public void testIntersectionTwoWraps()
    {
        Range<Token> wraps1 = new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("20"));
        Range<Token> wraps2 = new Range<Token>(new BigIntegerToken("120"), new BigIntegerToken("90"));
        Range<Token> wraps3 = new Range<Token>(new BigIntegerToken("120"), new BigIntegerToken("110"));
        Range<Token> wraps4 = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("0"));
        Range<Token> wraps5 = new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("1"));
        Range<Token> wraps6 = new Range<Token>(new BigIntegerToken("30"), new BigIntegerToken("10"));

        assertIntersection(wraps1,
                           wraps2,
                           new Range<Token>(new BigIntegerToken("120"), new BigIntegerToken("20")));
        assertIntersection(wraps1,
                           wraps3,
                           new Range<Token>(new BigIntegerToken("120"), new BigIntegerToken("20")),
                           new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("110")));
        assertIntersection(wraps1,
                           wraps4,
                           new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("20")),
                           new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("0")));
        assertIntersection(wraps1,
                           wraps5,
                           new Range<Token>(new BigIntegerToken("10"), new BigIntegerToken("20")),
                           new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("1")));
        assertIntersection(wraps1,
                           wraps6,
                           new Range<Token>(new BigIntegerToken("100"), new BigIntegerToken("10")));
    }

    @Test
    public void testByteTokensCompare()
    {
        Token t1 = new BytesToken(ByteBuffer.wrap(new byte[] { 1,2,3 }));
        Token t2 = new BytesToken(ByteBuffer.wrap(new byte[] { 1,2,3 }));
        Token t3 = new BytesToken(ByteBuffer.wrap(new byte[]{1, 2, 3, 4}));

        assert t1.compareTo(t2) == 0;
        assert t1.compareTo(t3) < 0;
        assert t3.compareTo(t1) > 0;
        assert t1.compareTo(t1) == 0;

        Token t4 = new BytesToken(new byte[] { 1,2,3 });
        Token t5 = new BytesToken(new byte[] { 4,5,6,7 });

        assert t4.compareTo(t5) < 0;
        assert t5.compareTo(t4) > 0;
        assert t1.compareTo(t4) == 0;
    }

    private Range<Token> makeRange(long token1, long token2)
    {
        return new Range<>(new Murmur3Partitioner.LongToken(token1), new Murmur3Partitioner.LongToken(token2));
    }

    private void assertRanges(Set<Range<Token>> result, Long ... tokens)
    {
        assert tokens.length % 2 ==0;

        final Set<Range<Token>> expected = new HashSet<>();
        for(int i=0; i < tokens.length; i+=2)
        {
            expected.add(makeRange(tokens[i], tokens[i+1]));
        }

        assertEquals(result, expected);
    }

    @Test
    public void testSubtractAll()
    {
        Range<Token> range = new Range<Token>(new Murmur3Partitioner.LongToken(1L), new Murmur3Partitioner.LongToken(100L));

        Collection<Range<Token>> collection = new HashSet<>();
        collection.add(makeRange(1L, 10L));
        assertRanges(range.subtractAll(collection), 10L, 100L);
        collection.add(makeRange(90L, 100L));
        assertRanges(range.subtractAll(collection), 10L, 90L);
        collection.add(makeRange(54L, 60L));
        assertRanges(range.subtractAll(collection), 10L, 54L, 60L, 90L);
        collection.add(makeRange(80L, 95L));
        assertRanges(range.subtractAll(collection), 10L, 54L, 60L, 80L);

        assertEquals(Collections.emptySet(), range.subtractAll(Collections.singleton(range)));
    }

    @Test
    public void testSubtractAllWithWrapAround()
    {
        Range<Token> range = new Range<Token>(new Murmur3Partitioner.LongToken(100L), new Murmur3Partitioner.LongToken(10L));

        Collection<Range<Token>> collection = new HashSet<>();
        collection.add(makeRange(20L, 30L));
        assertRanges(range.subtractAll(collection), 100L, 10L);
        collection.add(makeRange(200L, 500L));
        assertRanges(range.subtractAll(collection), 100L, 200L, 500L, 10L);
        collection.add(makeRange(1L, 10L));
        assertRanges(range.subtractAll(collection), 100L, 200L, 500L, 1L);
        collection.add(makeRange(0L, 1L));
        assertRanges(range.subtractAll(collection), 100L, 200L, 500L, 0L);
        collection.add(makeRange(1000L, 0));
        assertRanges(range.subtractAll(collection), 100L, 200L, 500L, 1000L);

        assertEquals(Collections.emptySet(), range.subtractAll(Collections.singleton(range)));
    }

    @Test
    public void testSubtractAllFromFullRingRange()
    {
        Range<Token> ring1 = makeRange(50L, 50L);
        Range<Token> ring2 = makeRange(0L, 0L);

        Set<Range<Token>> contained1 = Collections.singleton(makeRange(10L, 100L));
        Set<Range<Token>> contained2 = Collections.singleton(makeRange(100L, 10L));

        assertEquals(contained2, ring1.subtractAll(contained1));
        assertEquals(contained2, ring2.subtractAll(contained1));
        assertEquals(contained1, ring1.subtractAll(contained2));
        assertEquals(contained1, ring2.subtractAll(contained2));
        assertEquals(Collections.emptySet(), ring1.subtractAll(Collections.singleton(ring1)));
        assertEquals(Collections.emptySet(), ring2.subtractAll(Collections.singleton(ring2)));
        assertEquals(Collections.emptySet(), ring1.subtractAll(Collections.singleton(ring2)));
    }

    @Test
    public void testSubtractFromFullRingRange()
    {
        Range<Token> ring1 = makeRange(50L, 50L);
        Range<Token> ring2 = makeRange(0L, 0L);

        Range<Token> contained1 = makeRange(10L, 100L);
        Range<Token> contained2 = makeRange(100L, 10L);

        assertEquals(Collections.singleton(contained2), ring1.subtract(contained1));
        assertEquals(Collections.singleton(contained2), ring2.subtract(contained1));
        assertEquals(Collections.singleton(contained1), ring1.subtract(contained2));
        assertEquals(Collections.singleton(contained1), ring2.subtract(contained2));
        assertEquals(Collections.emptySet(), ring1.subtract(ring1));
        assertEquals(Collections.emptySet(), ring2.subtract(ring2));
        assertEquals(Collections.emptySet(), ring1.subtract(ring2));
    }
    
    private Range<Token> makeRange(String token1, String token2)
    {
        return new Range<Token>(new BigIntegerToken(token1), new BigIntegerToken(token2));
    }

    private Set<Range<Token>> makeRanges(String[][] tokenPairs)
    {
        Set<Range<Token>> ranges = new HashSet<Range<Token>>();
        for (int i = 0; i < tokenPairs.length; ++i)
            ranges.add(makeRange(tokenPairs[i][0], tokenPairs[i][1]));
        return ranges;
    }

    private void checkDifference(Range<Token> oldRange, String[][] newTokens, String[][] expected)
    {
        Set<Range<Token>> ranges = makeRanges(newTokens);
        for (Range<Token> newRange : ranges)
        {
            Set<Range<Token>> diff = oldRange.differenceToFetch(newRange);
            assert diff.equals(makeRanges(expected)) : "\n" +
                                                       "Old range: " + oldRange.toString() + "\n" +
                                                       "New range: " + newRange.toString() + "\n" +
                                                       "Difference: (result) " + diff.toString() + " != " + makeRanges(expected) + " (expected)";
        }
    }

    @Test
    public void testDifferenceToFetchNoWrap()
    {
        Range<Token> oldRange = makeRange("10", "40");

        // New range is entirely contained
        String[][] newTokens1 = { { "20", "30" }, { "10", "20" }, { "10", "40" }, { "20", "40" } };
        String[][] expected1 = { };
        checkDifference(oldRange, newTokens1, expected1);

        // Right half of the new range is needed
        String[][] newTokens2 = { { "10", "50" }, { "20", "50" }, { "40", "50" } };
        String[][] expected2 = { { "40", "50" } };
        checkDifference(oldRange, newTokens2, expected2);

        // Left half of the new range is needed
        String[][] newTokens3 = { { "0", "10" }, { "0", "20" }, { "0", "40" } };
        String[][] expected3 = { { "0", "10" } };
        checkDifference(oldRange, newTokens3, expected3);

        // Parts on both ends of the new range are needed
        String[][] newTokens4 = { { "0", "50" } };
        String[][] expected4 = { { "0", "10" }, { "40", "50" } };
        checkDifference(oldRange, newTokens4, expected4);
    }

    @Test
    public void testDifferenceToFetchBothWrap()
    {
        Range<Token> oldRange = makeRange("1010", "40");

        // New range is entirely contained
        String[][] newTokens1 = { { "1020", "30" }, { "1010", "20" }, { "1010", "40" }, { "1020", "40" } };
        String[][] expected1 = { };
        checkDifference(oldRange, newTokens1, expected1);

        // Right half of the new range is needed
        String[][] newTokens2 = { { "1010", "50" }, { "1020", "50" }, { "1040", "50" } };
        String[][] expected2 = { { "40", "50" } };
        checkDifference(oldRange, newTokens2, expected2);

        // Left half of the new range is needed
        String[][] newTokens3 = { { "1000", "10" }, { "1000", "20" }, { "1000", "40" } };
        String[][] expected3 = { { "1000", "1010" } };
        checkDifference(oldRange, newTokens3, expected3);

        // Parts on both ends of the new range are needed
        String[][] newTokens4 = { { "1000", "50" } };
        String[][] expected4 = { { "1000", "1010" }, { "40", "50" } };
        checkDifference(oldRange, newTokens4, expected4);
    }

    @Test
    public void testDifferenceToFetchOldWraps()
    {
        Range<Token> oldRange = makeRange("1010", "40");

        // New range is entirely contained
        String[][] newTokens1 = { { "0", "30" }, { "0", "40" }, { "10", "40" } };
        String[][] expected1 = { };
        checkDifference(oldRange, newTokens1, expected1);

        // Right half of the new range is needed
        String[][] newTokens2 = { { "0", "50" }, { "10", "50" }, { "40", "50" } };
        String[][] expected2 = { { "40", "50" } };
        checkDifference(oldRange, newTokens2, expected2);

        // Whole range is needed
        String[][] newTokens3 = { { "50", "90" } };
        String[][] expected3 = { { "50", "90" } };
        checkDifference(oldRange, newTokens3, expected3);

        // Both ends of the new range overlaps the old range
        String[][] newTokens4 = { { "10", "1010" }, { "40", "1010" }, { "10", "1030" }, { "40", "1030" } };
        String[][] expected4 = { { "40", "1010" } };
        checkDifference(oldRange, newTokens4, expected4);

        // Only RHS of the new range overlaps the old range
        String[][] newTokens5 = { { "60", "1010" }, { "60", "1030" } };
        String[][] expected5 = { { "60", "1010" } };
        checkDifference(oldRange, newTokens5, expected5);
    }

    @Test
    public void testDifferenceToFetchNewWraps()
    {
        Range<Token> oldRange = makeRange("0", "40");

        // Only the LHS of the new range is needed
        String[][] newTokens1 = { { "1010", "0" }, { "1010", "10" }, { "1010", "40" } };
        String[][] expected1 = { { "1010", "0" } };
        checkDifference(oldRange, newTokens1, expected1);

        // Both ends of the new range are needed
        String[][] newTokens2 = { { "1010", "50" } };
        String[][] expected2 = { { "1010", "0" }, { "40", "50" } };
        checkDifference(oldRange, newTokens2, expected2);

        oldRange = makeRange("20", "40");

        // Whole new range is needed
        String[][] newTokens3 = { { "1010", "0" } };
        String[][] expected3 = { { "1010", "0" } };
        checkDifference(oldRange, newTokens3, expected3);

        // Whole new range is needed (matching endpoints)
        String[][] newTokens4 = { { "1010", "20" } };
        String[][] expected4 = { { "1010", "20" } };
        checkDifference(oldRange, newTokens4, expected4);

        // Only RHS of new range is needed
        String[][] newTokens5 = { { "30", "0" }, { "40", "0" } };
        String[][] expected5 = { { "40", "0" } };
        checkDifference(oldRange, newTokens5, expected5);

        // Only RHS of new range is needed (matching endpoints)
        String[][] newTokens6 = { { "30", "20" }, { "40", "20" } };
        String[][] expected6 = { { "40", "20" } };
        checkDifference(oldRange, newTokens6, expected6);
    }

    private <T extends RingPosition<T>> void assertNormalize(List<Range<T>> input, List<Range<T>> expected)
    {
        List<Range<T>> result = normalize(input);
        assert result.equals(expected) : "Expecting " + expected + " but got " + result;
    }

    @Test
    public void testNormalizeNoop()
    {
        List<Range<PartitionPosition>> l;

        l = asList(range("1", "3"), range("4", "5"));
        assertNormalize(l, l);
    }

    @Test
    public void testNormalizeSimpleOverlap()
    {
        List<Range<PartitionPosition>> input, expected;

        input = asList(range("1", "4"), range("3", "5"));
        expected = asList(range("1", "5"));
        assertNormalize(input, expected);

        input = asList(range("1", "4"), range("1", "4"));
        expected = asList(range("1", "4"));
        assertNormalize(input, expected);
    }

    @Test
    public void testNormalizeSort()
    {
        List<Range<PartitionPosition>> input, expected;

        input = asList(range("4", "5"), range("1", "3"));
        expected = asList(range("1", "3"), range("4", "5"));
        assertNormalize(input, expected);
    }

    @Test
    public void testNormalizeUnwrap()
    {
        List<Range<PartitionPosition>> input, expected;

        input = asList(range("9", "2"));
        expected = asList(range("", "2"), range("9", ""));
        assertNormalize(input, expected);
    }

    @Test
    public void testNormalizeComplex()
    {
        List<Range<PartitionPosition>> input, expected;

        input = asList(range("8", "2"), range("7", "9"), range("4", "5"));
        expected = asList(range("", "2"), range("4", "5"), range("7", ""));
        assertNormalize(input, expected);

        input = asList(range("5", "9"), range("2", "5"));
        expected = asList(range("2", "9"));
        assertNormalize(input, expected);

        input = asList(range ("", "1"), range("9", "2"), range("4", "5"), range("", ""));
        expected = asList(range("", ""));
        assertNormalize(input, expected);

        input = asList(range ("", "1"), range("1", "4"), range("4", "5"), range("5", ""));
        expected = asList(range("", ""));
        assertNormalize(input, expected);
    }

    @Test
    public void testRandomOrderedRangeContainmentChecker()
    {
        Random r = new Random();
        for (int j = 0; j < 1000; j++)
        {
            int numTokens = r.nextInt(300) + 1;
            List<Range<Token>> ranges = new ArrayList<>(numTokens);
            List<Token> tokens = new ArrayList<>(2 * numTokens);
            for (int i = 0; i < 2 * numTokens; i++)
                tokens.add(t(r.nextLong()));

            Collections.sort(tokens);

            for (int i = 0; i < tokens.size(); i++)
            {
                ranges.add(new Range<>(tokens.get(i), tokens.get(i + 1)));
                i++;
            }

            List<Token> tokensToTest = new ArrayList<>();
            for (int i = 0; i < 10000; i++)
                tokensToTest.add(t(r.nextLong()));

            tokensToTest.add(t(Long.MAX_VALUE));
            tokensToTest.add(t(Long.MIN_VALUE));
            tokensToTest.add(t(Long.MAX_VALUE - 1));
            tokensToTest.add(t(Long.MIN_VALUE + 1));
            Collections.sort(tokensToTest);

            Range.OrderedRangeContainmentChecker checker = new Range.OrderedRangeContainmentChecker(ranges);
            for (Token t : tokensToTest)
            {
                if (checker.test(t) != Range.isInRanges(t, ranges)) // avoid running Joiner.on(..) every iteration
                    fail(format("This should never flap! If it does, it is a bug (ranges = %s, token = %s)", Joiner.on(",").join(ranges), t));
            }
        }
    }

    @Test
    public void testBoundariesORCC()
    {
        List<Range<Token>> ranges = asList(r(Long.MIN_VALUE, Long.MIN_VALUE + 1), r(Long.MAX_VALUE - 1, Long.MAX_VALUE));
        Range.OrderedRangeContainmentChecker checker = new Range.OrderedRangeContainmentChecker(ranges);
        assertFalse(checker.test(t(Long.MIN_VALUE)));
        assertTrue(checker.test(t(Long.MIN_VALUE + 1)));
        assertFalse(checker.test(t(0)));
        assertFalse(checker.test(t(Long.MAX_VALUE - 1)));
        assertTrue(checker.test(t(Long.MAX_VALUE)));
    }

    private static Range<Token> r(long left, long right)
    {
        return new Range<>(t(left), t(right));
    }

    private static Range<Token> r(Token left, Token right)
    {
        return new Range<>(left, right);
    }

    private static Token t(long t)
    {
        return new Murmur3Partitioner.LongToken(t);
    }

    @Test
    public void testCompareTo_SameObject_WrapAround()
    {
        Range<Token> range = r(10, -10);
        assertEquals(0, range.compareTo(range));
    }

    @Test
    public void testCompareTo_BothWrapAround()
    {
        Range<Token> r0 = r(10, -10);
        Range<Token> r1 = r(20, -5);
        assertNotSame(r0.compareTo(r1), r1.compareTo(r0));
    }

    @Test
    public void testGroupIntersect()
    {
        assertTrue(Range.intersects(asList(r(1, 5), r(10, 15)), asList(r(4, 6), r(20, 25))));
        assertFalse(Range.intersects(asList(r(1, 5), r(10, 15)), asList(r(6, 7), r(20, 25))));
    }

    @Test
    public void testGroupSubtract()
    {
        Collection<Range<Token>> ranges = Sets.newHashSet(r(1, 5), r(10, 15));
        assertEquals(ranges, Range.subtract(ranges, asList(r(6, 7), r(20, 25))));
        assertEquals(Sets.newHashSet(r(1, 4), r(11, 15)), Range.subtract(ranges, asList(r(4, 7), r(8, 11))));
    }

    @Test
    public void testIntersectsBounds()
    {
        Range<Token> r = r(0, 100);
        assertTrue(r.intersects(bounds(5, 10)));
        assertTrue(r.intersects(bounds(100, 110)));
        assertTrue(r.intersects(bounds(-100, 200)));
        assertTrue(r.intersects(bounds(10, 15)));
        assertTrue(r.intersects(bounds(20,20)));

        assertFalse(r.intersects(bounds(-5, 0)));
        assertFalse(r.intersects(bounds(-5, -1)));
        assertFalse(r.intersects(bounds(110, 114)));
    }

    private static Bounds<Token> bounds(long left, long right)
    {
        return new Bounds<>(t(left), t(right));
    }

    private static AbstractBounds<PartitionPosition> bounds(PartitionPosition left, boolean leftInclusive, PartitionPosition right, boolean rightInclusive)
    {
        return AbstractBounds.bounds(left, leftInclusive, right, rightInclusive);
    }

    @Test
    @UseMurmur3Partitioner
    public void testIsInNormalizedRanges()
    {
        NormalizedRanges<Token> ranges = normalizedRanges(ImmutableList.of(fromString("(1,10]"), fromString("(10,20]"), fromString("(30,40]"), fromString("(50,60]"), fromString("(60,70]"), fromString("(80,90]"), fromString("(" + Long.MAX_VALUE + ",-9223372036854775808]")));
        for (int ii = 0; ii < 100; ii++)
        {
            boolean isIn = ranges.intersects(new LongToken(ii));
            if (ii > 1 && ii <= 20)
                assertTrue("Index " + ii, isIn);
            else if (ii > 30 && ii <= 40)
                assertTrue("Index " + ii, isIn);
            else if (ii > 50 && ii <= 70)
                assertTrue("Index " + ii, isIn);
            else if (ii > 80 && ii <= 90)
                assertTrue("Index " + ii, isIn);
            else
                assertFalse("Index " + ii, isIn);
        }
        assertFalse(ranges.intersects(new LongToken(Long.MAX_VALUE)));
        assertTrue(ranges.intersects(new LongToken(Long.MIN_VALUE)));
        ranges = normalizedRanges(ImmutableList.of(fromString("(-9223372036854775808,-9223372036854775807]")));
        assertFalse(ranges.intersects(new LongToken(Long.MIN_VALUE)));
        assertTrue(ranges.intersects(new LongToken(Long.MIN_VALUE + 1)));
        ranges = normalizedRanges(ImmutableList.of(fromString("(" + (Long.MAX_VALUE - 1) + ",-9223372036854775808]")));
        assertFalse(ranges.intersects(new LongToken(Long.MAX_VALUE - 1)));
        assertTrue(ranges.intersects(new LongToken(Long.MAX_VALUE)));
        assertTrue(ranges.intersects(new LongToken(Long.MIN_VALUE)));
        assertFalse(ranges.intersects(new LongToken(Long.MAX_VALUE - 1)));
        assertTrue(ranges.intersects(new LongToken(Long.MAX_VALUE)));
        assertTrue(ranges.intersects(new LongToken(Long.MIN_VALUE)));
    }

    @Test
    @UseMurmur3Partitioner
    public void testSubtractNormalizedRanges()
    {
        NormalizedRanges<Token> ranges = normalizedRanges(ImmutableList.of(fromString("(1,10]"), fromString("(10,20]"), fromString("(30,40]"), fromString("(50,60]"), fromString("(60,70]"), fromString("(80,90]"), fromString("(" + Long.MAX_VALUE + ",-9223372036854775808]")));
        for (int ii = 0; ii < 100; ii++)
        {
            boolean isIn = ranges.intersects(new LongToken(ii));
            if (ii > 1 && ii <= 20)
                assertTrue("Index " + ii, isIn);
            else if (ii > 30 && ii <= 40)
                assertTrue("Index " + ii, isIn);
            else if (ii > 50 && ii <= 70)
                assertTrue("Index " + ii, isIn);
            else if (ii > 80 && ii <= 90)
                assertTrue("Index " + ii, isIn);
            else
                assertFalse("Index " + ii, isIn);
        }
        NormalizedRanges<Token> rightMostRange = normalizedRanges(ImmutableList.of(r(Long.MAX_VALUE, Long.MIN_VALUE)));
        NormalizedRanges<Token> maxLongRange = normalizedRanges(ImmutableList.of(r(Long.MAX_VALUE - 1, Long.MAX_VALUE)));

        assertEquals(emptyList(),  ranges.subtract(ranges));
        assertEquals(emptyList(), rightMostRange.subtract(ranges));
        assertEquals(maxLongRange, maxLongRange.subtract(ranges));
        ranges = maxLongRange;
        assertEquals(emptyList(), ranges.subtract(ranges));
        assertEquals(rightMostRange, rightMostRange.subtract(ranges));
        assertEquals(emptyList(), maxLongRange.subtract(ranges));
        ranges = normalizedRanges(ImmutableList.of(fromString("(" + (Long.MAX_VALUE - 1) + ",-9223372036854775808]")));
        assertEquals(emptyList(), ranges.subtract(ranges));
        assertEquals(emptyList(), rightMostRange.subtract(ranges));
        assertEquals(emptyList(), maxLongRange.subtract(ranges));
    }

    @Test
    public void testExpensiveChecksBurn()
    {
        long seed = System.nanoTime();
        System.out.println(seed);
        Random r = new java.util.Random(seed);

        Stopwatch elapsed = Stopwatch.createStarted();
        while (elapsed.elapsed(SECONDS) != 10)
        {
            int numRanges = 3;
            List<Range<Token>> aList = new ArrayList();
            for (int ii = 0; ii < numRanges; ii++)
            {
                aList.add(new Range<>(new LongToken(r.nextLong()), new LongToken(r.nextLong())));
            }
            NormalizedRanges<Token> a = normalizedRanges(aList);
            List<Range<Token>> bList = new ArrayList();
            for (int ii = 0; ii < numRanges; ii++)
            {
                bList.add(new Range<>(new LongToken(r.nextLong()), new LongToken(r.nextLong())));
            }
            NormalizedRanges<Token> b = normalizedRanges(bList);

            for (int ii = 0; ii < 1000; ii++)
            {
                Token t = new LongToken(r.nextLong());
                a.intersects(t);
                b.intersects(t);
            }

            a.intersection(b);
            a.intersection(a);
            b.intersection(a);
            b.intersection(b);

            a.subtract(b);
            a.subtract(a);
            b.subtract(a);
            b.subtract(b);

            if (!a.isEmpty())
                a.invert();
            if (!b.isEmpty())
                b.invert();
        }
    }

    @Test
    public void testIntersectionAndRemainder()
    {
        // Intersection will only make max key bounds so use minKeyBound
        // so you know where the bound came from
        Token oneT = t(1);
        PartitionPosition onePP = oneT.minKeyBound();
        Token twoT = t(2);
        PartitionPosition twoPP = twoT.minKeyBound();
        Token threeT = t(3);
        PartitionPosition threePP = threeT.minKeyBound();
        Token fourT = t(4);
        PartitionPosition fourPP = fourT.minKeyBound();
        Token fiveT = t(5);
        PartitionPosition fivePP = fiveT.minKeyBound();
        Token sixT = t(6);
        PartitionPosition sixPP = sixT.minKeyBound();
        Token sevenT = t(7);
        PartitionPosition sevenPP = sevenT.minKeyBound();
        Token eightT = t(8);
        PartitionPosition eightPP = eightT.minKeyBound();
        Token minT = Murmur3Partitioner.MINIMUM;
        PartitionPosition minPP = minT.minKeyBound();

        Range<Token> r = r(threeT, sixT);

        // Completely before
        testInclusivity(onePP, twoPP, r,
                        Pair.create(null, null),
                        Pair.create(null, null),
                        Pair.create(null, null),
                        Pair.create(null, null));

        // Completely after
        testInclusivity(sevenPP, eightPP, r,
                        Pair.create(null, bounds(sevenPP, true, eightPP, true)),
                        Pair.create(null, bounds(sevenPP, true, eightPP, false)),
                        Pair.create(null, bounds(sevenPP, false, eightPP, true)),
                        Pair.create(null, bounds(sevenPP, false, eightPP, false)));

        // Overlapping
        testInclusivity(threePP, sixPP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixPP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixPP, false), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixPP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixPP, false), null));

        // Completely contained by range, should echo back the same bound
        testInclusivity(fourPP, fivePP, r,
                        Pair.create(bounds(fourPP, true, fivePP, true), null),
                        Pair.create(bounds(fourPP, true, fivePP, false), null),
                        Pair.create(bounds(fourPP, false, fivePP, true), null),
                        Pair.create(bounds(fourPP, false, fivePP, false), null));

        // Overlap left only
        testInclusivity(threePP, fivePP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null));

        // Overlap right only
        testInclusivity(fourPP, sixPP, r,
                        Pair.create(bounds(fourPP, true, sixPP, true), null),
                        Pair.create(bounds(fourPP, true, sixPP, false), null),
                        Pair.create(bounds(fourPP, false, sixPP, true), null),
                        Pair.create(bounds(fourPP, false, sixPP, false), null));

        // Contains range
        testInclusivity(twoPP, sevenPP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, true)),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, false)),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, true)),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, false)));

        // Split by range left bound
        testInclusivity(twoPP, fivePP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null));

        // Split by range right bound
        testInclusivity(fivePP, sevenPP, r,
                        Pair.create(bounds(fivePP, true, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, true)),
                        Pair.create(bounds(fivePP, true, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, false)),
                        Pair.create(bounds(fivePP, false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, true)),
                        Pair.create(bounds(fivePP, false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, sevenPP, false)));

        /*
         * Test size 1 bound
         */
        // Completely before
        testInclusivity(onePP, onePP, r,
                        Pair.create(null, null));

        // Completely after
        testInclusivity(eightPP, eightPP, r,
                        Pair.create(null, bounds(eightPP, true, eightPP, true)));

        // Completely contained by range, should echo back the same bound
        testInclusivity(fivePP, fivePP, r,
                        Pair.create(bounds(fivePP, true, fivePP, true), null));

        // Overlap left only
        testInclusivity(threePP, threePP, r,
                        Pair.create(null, null));

        // Overlap right only
        testInclusivity(sixPP, sixPP, r,
                        Pair.create(bounds(sixPP, true, sixPP, true), null));

        /*
         * Test all cases where the right of Bounds is minimum
         */
        // Completely after
        testInclusivity(sevenPP, minPP, r,
                        Pair.create(null, bounds(sevenPP, true, minPP, true)),
                        Pair.create(null, bounds(sevenPP, true, minPP, false)),
                        Pair.create(null, bounds(sevenPP, false, minPP, true)),
                        Pair.create(null, bounds(sevenPP, false, minPP, false)));

        // Contains range
        testInclusivity(twoPP, minPP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, true)),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, false)),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, true)),
                        Pair.create(bounds(threeT.maxKeyBound(), false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, false)));

        // Split by range right bound
        testInclusivity(fivePP, minPP, r,
                        Pair.create(bounds(fivePP, true, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, true)),
                        Pair.create(bounds(fivePP, true, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, false)),
                        Pair.create(bounds(fivePP, false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, true)),
                        Pair.create(bounds(fivePP, false, sixT.maxKeyBound(), true), bounds(sixT.maxKeyBound(), false, minPP, false)));

        /*
         * Test all cases where the right of the range is minimum
         */
        r = r(threeT, minT);
        // Completely before
        testInclusivity(onePP, twoPP, r,
                        Pair.create(null, null),
                        Pair.create(null, null),
                        Pair.create(null, null),
                        Pair.create(null, null));

        // Overlapping
        testInclusivity(threePP, minPP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, false), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, false), null));

        // Completely contained by range, should echo back the same bound
        testInclusivity(fourPP, fivePP, r,
                        Pair.create(bounds(fourPP, true, fivePP, true), null),
                        Pair.create(bounds(fourPP, true, fivePP, false), null),
                        Pair.create(bounds(fourPP, false, fivePP, true), null),
                        Pair.create(bounds(fourPP, false, fivePP, false), null));

        // Overlap left only
        testInclusivity(threePP, fivePP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null));

        // Overlap right only
        testInclusivity(fourPP, minPP, r,
                        Pair.create(bounds(fourPP, true, minPP, true), null),
                        Pair.create(bounds(fourPP, true, minPP, false), null),
                        Pair.create(bounds(fourPP, false, minPP, true), null),
                        Pair.create(bounds(fourPP, false, minPP, false), null));

        // Contains range
        testInclusivity(twoPP, minPP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, false), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, minPP, false), null));

        // Split by range left bound
        testInclusivity(twoPP, fivePP, r,
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, true), null),
                        Pair.create(bounds(threeT.maxKeyBound(), false, fivePP, false), null));
    }

    private void testInclusivity(PartitionPosition left, PartitionPosition right, Range<Token> range,
                                 Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>> expected)
    {
        testInclusivity(left, right, range, expected, null, null, null);
    }

    private void testInclusivity(PartitionPosition left, PartitionPosition right, Range<Token> range,
                                 Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>> expected1,
                                 Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>> expected2,
                                 Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>> expected3,
                                 Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>> expected4)
    {
        testInclusivity(left, right, range, new Pair[] { expected1, expected2, expected3, expected4 });
    }

    private void testInclusivity(PartitionPosition left, PartitionPosition right, Range<Token> range,
                                 Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>>[] expecteds)
    {
        int i = 0;
        for (Boolean leftInclusive : ImmutableList.of(true, false))
        {
            for (Boolean rightInclusive : ImmutableList.of(true, false))
            {
                Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>> expected = expecteds[i++];
                if (expected == null)
                    continue;
                AbstractBounds<PartitionPosition> expectedIntersection = expected.left;
                AbstractBounds<PartitionPosition> expectedRemainder = expected.right;
                AbstractBounds<PartitionPosition> testBounds = bounds(left, leftInclusive, right, rightInclusive);
                Pair<AbstractBounds<PartitionPosition>, AbstractBounds<PartitionPosition>> interSectionAndRemainder = intersectionAndRemainder(testBounds, range);
                AbstractBounds<PartitionPosition> intersection = interSectionAndRemainder.left;
                AbstractBounds<PartitionPosition> remainder = interSectionAndRemainder.right;
                String message = format("Expected %s intersecting inclusive left %b, inclusive right %b, %s with %s", expected, leftInclusive, rightInclusive, bounds(left, leftInclusive, right, rightInclusive), range);
                assertEquals(message, expected, intersectionAndRemainder(bounds(left, leftInclusive, right, rightInclusive), range));
                System.out.println(message.replace("Expected", "Expecting"));

                if (remainder == testBounds)
                    assertNull(intersection);
                if (intersection == testBounds)
                    assertNull(remainder);
                if (Objects.equals(remainder, testBounds) && remainder != testBounds)
                    fail("Should return existing bounds");
                if (Objects.equals(intersection, testBounds) && intersection != testBounds)
                    fail("Should return existing bounds");

                // Need to validate that we roundtrip the actual exact input PartitionPosition and don't lose part of the input bound that might be needed
                // Remainder can either be the entire thing because there is no intersection
                // Remainder should always preserve the right bound since range is right inclusive, the left bound will always be a `maxKeyBound` from the range
                if (remainder != null && remainder != testBounds)
                {
                    assertTrue(remainder.right == expectedRemainder.right);
                    assertTrue(remainder.right == right);
                    assertEquals(remainder.inclusiveRight(), expectedRemainder.inclusiveRight());
                    assertFalse(remainder.inclusiveLeft());
                    assertFalse(remainder.left == left);
                    // Not strictly necessary, but we do always use the left of the range and create a new key bound
                    assertEquals(remainder.left, range.right.maxKeyBound());
                }

                // Range is left exclusive so the left should be preserved if it is greater than range left
                // otherwise it should be replaced
                if (intersection != null && intersection != testBounds)
                {
                    if (intersection.left.getToken().compareTo(range.left) > 0)
                    {
                        assertEquals(intersection.inclusiveLeft(), expectedIntersection.inclusiveLeft());
                        assertTrue(intersection.inclusiveRight());
                        assertTrue(intersection.left == expectedIntersection.left);
                        assertTrue(intersection.left == left);
                    }
                    else
                    {
                        // Should be replaced by a KeyBound from the range
                        assertTrue(intersection.left != expectedIntersection.left);
                        assertTrue(intersection.left != left);
                        // Max bound since range is not left inclusive and excluded
                        assertEquals(intersection.left, range.left.maxKeyBound());
                    }
                }
            }
        }
    }

    @Test
    public void testGroupIntersection()
    {
        assertEquals(Collections.emptyList(),
                     Range.intersect(asList(r(1, 5), r(10, 15)),
                                     asList(r(6, 7), r(20, 25))
        ));

        assertEquals(asList(r(5, 6)),
                     Range.intersect(asList(r(1, 6), r(10, 15)),
                                     asList(r(5, 10))
        ));

        assertEquals(asList(r(5, 6), r(10, 11)),
                     Range.intersect(asList(r(1, 6), r(10, 15)),
                                     asList(r(5, 11))
                     ));

        assertEquals(asList(r(5, 6), r(10, 11)),
                     Range.intersect(asList(r(1, 6), r(10, 15)),
                                     asList(r(5, 11))
                     ));

        assertEquals(asList(r(5, 6), r(10, 11), r(12, 15)),
                     Range.intersect(asList(r(1, 6), r(10, 15)),
                                     asList(r(5, 11), r(12, 20))
                     ));

        assertEquals(asList(r(5, 6), r(10, 15)),
                     Range.intersect(asList(r(1, 6), r(10, 15)),
                                     asList(r(5, 11), r(11, 20))
                     ));

        assertEquals(Collections.emptyList(),
                     Range.intersect(Collections.emptyList(),
                                     asList(r(5, 11), r(11, 20))
                     ));

        assertEquals(Collections.emptyList(),
                     Range.intersect(asList(r(1, 6), r(10, 15)),
                                     Collections.emptyList()
                     ));
    }
}
